Repository navigation
docs: update the SecureBoot imager output for v1.14 and v1.15 - #937
Open
Iheanacho-ai wants to merge 1 commit into
Open
Iheanacho-ai wants to merge 1 commit into
Iheanacho-ai wants to merge 1 commit into
Conversation
Talos 1.14 dropped lockdown=confidentiality from the SecureBoot kernel command line, and the imager profile now nests the signing keys under secureBootSigner and pcrSigner. Replace the secureboot-iso and secureboot-installer examples with the output of the v1.14.5 and v1.15.0-beta.0 imagers, and split the prompt-and-output code blocks into command and output blocks. Signed-off-by: Amarachi Iheanacho <amarachi.iheanacho@siderolabs.com>
Contributor
Preview approval requiredThis pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit |
📋 Automated documentation reviewAn automated pass runs on documentation changes in every PR. The items below are suggestions to consider — advisory, not a merge gate. Reviewed commit Nothing flagged at critical or warning level — see any notices inline. Notices, and the reviewer's full report, are in the run's |
sterlingkoch
approved these changes
Nov 11, 2026
This branch has not been deployed
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Updates the SecureBoot imager output examples for v1.14 and v1.15 so they match what the imager prints today.
Why
Both examples showed
lockdown=confidentialityon the kernel command line. Talos dropped that default in 1.14.0 (siderolabs/talos@35c8f172c), so SecureBoot images now run withlockdown=integrityimplicitly. The examples were also from a much older Talos: they had aninstaller-base:v1.5.0-alpha.3-…-dirtyimage reference, the old signing-key layout (signingKeyPath,pcrPublicKeyPath), and old kernel arguments.Change
secureboot-isoandsecureboot-installeroutput on the v1.14 and v1.15 SecureBoot pages with the real output of the commands on each page. The examples now show:secureBootSignerandpcrSignerkey layoutisoOptions(ISO example)lockdown=confidentialityinstaller-basetag${release_v1_14}and${release_v1_15}.$prompt-and-output code blocks on each page into a command block and an output block, as the style check requires. The same split is in thetalos-secureboot-kexecbranch, so the two don't conflict.Testing
lockdown=confidentialityis added only for Talos versions below 1.14.0 (ForcesLockdownConfidentialityinpkg/machinery/imager/quirks/quirks.go, called fromSecureBootArgsinpkg/machinery/kernel/kernel.go). The threshold is the same in v1.14.0, v1.14.5, and v1.15.0-beta.0.talosctlv1.15.0-beta.0 (gen secureboot uki,pcr,database), then ran both page commands with the amd64imager:v1.15.0-beta.0andimager:v1.14.5. All four runs succeeded. The examples are their output, leaving out only the progress spinner lines.make style-check-changed-local(0 errors) andmake canonical-links-check. Neither page has anylockdown,pcr-signing-public-key, orinit_on_allocleft.talosctl get securitystateexample on these pages still shows only theSECUREBOOTcolumn, while Talos 1.15 has more columns. It's left for a follow-up, because its real output needs a SecureBoot machine.